package cn.cjxy.springboot_zonghe_practice.service;

import cn.cjxy.springboot_zonghe_practice.domain.Employee;
import cn.cjxy.springboot_zonghe_practice.query.BaseQuery;
import cn.cjxy.springboot_zonghe_practice.utils.R;

import java.util.List;

/**
 * 员工服务接口
 * 提供员工的增删改查、分页查询、批量操作、统计查询等功能
 * 
 * @author huangjie
 * @since 2025-07-06
 */
public interface EmployeeService {
    
    /**
     * 添加员工
     * 业务规则：
     * 1. 身份证号不能重复
     * 2. 手机号不能重复
     * 
     * @param employee 员工信息对象
     * @return 操作结果，成功返回R.ok()，失败返回R.fail(错误信息)
     */
    R addEmployee(Employee employee);
    
    /**
     * 修改员工信息
     * 业务规则：
     * 1. 身份证号不能与其他员工重复（排除自己）
     * 2. 手机号不能与其他员工重复（排除自己）
     * 
     * @param employee 员工信息对象（必须包含id）
     * @return 操作结果
     */
    R updateEmployee(Employee employee);
    
    /**
     * 根据ID删除员工
     * 业务规则：有部门的员工不可以被删除
     * 
     * @param id 员工ID
     * @return 操作结果
     */
    R deleteEmployeeById(Long id);
    
    /**
     * 根据ID查询员工信息
     * 
     * @param id 员工ID
     * @return 查询结果，包含员工详细信息
     */
    R selectEmployeeById(Long id);
    
    /**
     * 分页查询员工
     * 
     * @param query 分页查询参数，包含页码和每页大小
     * @return 分页结果，包含员工列表、总数、当前页码、每页大小
     */
    R selectEmployeeByPage(BaseQuery query);
    
    /**
     * 批量添加员工
     * 业务规则：
     * 1. 身份证号不能重复
     * 2. 手机号不能重复
     * 
     * @param employees 员工列表
     * @return 操作结果
     */
    R batchAddEmployee(List<Employee> employees);
    
    /**
     * 批量删除员工
     * 业务规则：有部门的员工不可以被删除
     * 
     * @param ids 员工ID列表
     * @return 操作结果
     */
    R batchDeleteEmployee(List<Long> ids);
    
    /**
     * 统计各部门人数
     * 返回每个部门的名称和员工数量
     * 
     * @return 统计结果，包含部门名称和员工数量
     */
    R selectDeptEmployeeCount();
    
    /**
     * 统计各部门最高薪水员工
     * 返回每个部门中薪水最高的员工信息
     * 
     * @return 统计结果，包含部门名称、员工姓名、最高薪水
     */
    R selectDeptMaxSalaryEmployee();
    
    /**
     * 统计各部门薪水总和
     * 返回每个部门的薪水总额
     * 
     * @return 统计结果，包含部门名称和薪水总和
     */
    R selectDeptTotalSalary();
} 